home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format: Get the Most Out of Your Amiga / Amiga Format - Get the Most Out of Your Amiga (1991)(Future Publishing)(GB)(Disk 2 of 2).adf / RSLClock / RSLClock.doc < prev    next >
Text File  |  1978-06-20  |  10KB  |  166 lines
  1.     RSLClock is a superficially simple little utility that "runs" 
  2. unobtrusively at the end of the screen title bar.  The "close" gadget 
  3. and "window to front/back" gadgets are there, but they are hidden from view! 
  4. There it sits, indicating both the currently free memory, the time, and once 
  5. a minute, the date. It also "pops up" to the front of the Workbench screen, 
  6. once every minute. If you would like military time you can run the program 
  7. with "Run RSLClock long" it will then read out 12 hour time in AM/PM type 
  8. (hours & minutes), otherwise the default setting is Hours:minutes in 12 hour 
  9. style.
  10.      SYNTAX:
  11.         LONG (this will toggle military 24 hour time with HH:MM:SS style)        
  12.         BACK (this will create a "backdrop" black screen that can be toggled
  13.                 in/out by using left-Amiga N/M keys or by double clicking
  14.                 the menu button when the window is activated - use it
  15.                 to hide the current screen)
  16.         NOPOPUP (this disables the feature to "pop" the clock window to front of
  17.                 workbench screen at the beginning of every minute)
  18.         SPLITUP (this will split up the memory display into free chip and
  19.                 fast memory, separately)     
  20.         COLOR [B],[D] (this sets the colors of the window pen - first number
  21.                 can be 0-3, and background pen - second number can be 0-3.
  22.                 Any other numbers will give you the default colors)
  23.         POSITION [X],[Y] (this sets the left top edge of the window if the
  24.                 given width allows it, should you be utilizing WB 1.2 in
  25.                 400 line Workbench mode use an asterisk * and a space before
  26.                 the position commands in order for the program to recognize more
  27.                 than 200 lines per screen) 
  28.         TINY (this shrinks the display window to its minimum dimensions)
  29.         HIGHLIGHT [D] (this enables highlighting of the "Time:" type labels
  30.                 in the display window, by using 'I' instead of a number the
  31.                 labels will be made invisible)
  32.         [disk drive] (i.e. DF1: this will indicate the number of free Kbytes
  33.                 on indicated disk drive, re-evaluated once every minute!)
  34.         [# Kbytes before emergency shutdown] (i.e. 25 this will shut down
  35.                 this utility and reclaim the memory if your system's free
  36.                 memory falls below this point, default is 10 Kbytes!)
  37.         "[command line]" (this will automatically run a program when the
  38.                 copyright notice submenu is selected (the notice that says:
  39.                 ***RSLClockPlus by Roy S. Laufer, ***) i.e. "RUN STARTERM"
  40.                 will startup Starterm if it is available!  Caution: this
  41.                 default setting MUST be the last arguments, and MUST be
  42.                 enclosed in quotations!)
  43.          ? (this will display syntax)
  44.  
  45.         Note single letters are the same as typing the entire command!  
  46.         As an example RUN RSLClock b s DF1: p 120,45  will run the program
  47. with a backdrop screen, split memory into it's chip and fast components,
  48. display info on DF1: and displace the window to the given coordinates!
  49. *****************************************************************************
  50. New In Version 1.1:
  51.      This new update includes a menu which allows you to change all of the
  52. available options of RSLClockPlus, after it is running.  An additional
  53. feature available via the Menu is the ability to summon an emergency CLI
  54. which runs completely independent of all other tasks.  Since RSLClockPlus
  55. always pops up in front of all other Workbench windows, this may be helpful
  56. when there isn't any other way to get into a CLI.  I found PopCLI redundant
  57. with this feature available, but be cautious since this feature, like
  58. EXECUTE, takes 40 odd bytes from your memory and won't give it back without
  59. a warmboot!  A very small price to pay!.  Also, if the backdrop screen is
  60. enabled and the RSLClockPlus window is activated, simply double clicking the
  61. right menu button twice will toggle you in and out of the backdrop screen!
  62.       In addition to the new features, the older features have been
  63. "polished" up a bit!  Although the program is a bit larger than 1.0, I think
  64. that it is worth it.  To the best of my knowledge it runs on both 1.1 and
  65. 1.2 (beta 4).  Please tell me if there are any problems running it under any
  66. of the available versions of KS!
  67. *****************************************************************************
  68.      
  69. *****************************************************************************
  70. New in Version 1.11:
  71.      There is an unfortunate flaw in the ctime() function which came with
  72. my Aztec compiler, which I had to build a "fix" for.  Now the date will
  73. not be displayed as "Nov 0" when in fact it is "Oct 31"!
  74.      Another problem fixed in Ver 1.11 is due to the fact that the device
  75. driver for the floppy drives think that there are only 488 bytes per block,
  76. instead of 512, which is the way that INFO calculates it!  Since everyone
  77. believes INFO, I have adjusted this "anomaly" so that the free bytes of the
  78. disk drive will be the same as displayed using the INFO command!
  79. ****************************************************************************
  80.  
  81. ****************************************************************************
  82. New in Version 1.2:
  83.      I have found out that there in fact is ONLY 448 bytes per block on the
  84. disk drive!  the remaining 24 bytes are used by AmigaDOS as its overhead.
  85. I have decided that in a rebellious mood I will display what space is really
  86. available to you, the user instead of the "Public Relations" space available
  87. indicated via the INFO command.  Truth is more important than having my program
  88. agree with INFO's inaccurate value!  So back to a 5% discrepancy with INFO's
  89. value!
  90.      COLOR, and POSITION commands have been included in this version.  I happen
  91. to prefer the default values (of course I do, I wrote them into it as defaults),
  92. but if you people want to customize it you own liking, GO AHEAD! Of course,
  93. the menu allows you to change colors "on the run".
  94.      In previous versions only 3 significant digits were displayed for 
  95. Kbytes free on peripheral storage devices.  This is fine for floppies, but
  96. not for hard disks.  In this version hard disks will be displayed with 5
  97. significant numbers (if you have MORE than 99999K Bytes free, you shouldn't
  98. be caring about your available free memory)!
  99.       Another small feature added in this version update, is that once the
  100. backdrop is enabled and brought to the front by double clicking the right
  101. menu mouse button, simply hitting any key on the keyboard will bring back
  102. the previously active screen and activate the last window used!
  103. ****************************************************************************
  104.  
  105. ****************************************************************************
  106. New in Version 1.3:
  107.      The "PopUp" feature has been modified - it has an added "Hyper"
  108. feature.  Use it with caution - it is able to PopUp onto any medium 
  109. and high resolution screen that is currently in front, but don't close
  110. screens while RSLClock is on that screen, otherwise your Amiga may or
  111. may not go BYE-BYE!  I tried to have it popup on lo-res, but the menus 
  112. get all screwed up.
  113.      An additional device has been added to the menu choice.  It is called
  114. VD0: for virtual device.  This is the device used in ASDG's recoverable
  115. RamDisk device (no, I don't own one yet, but I can hope, can't I?).  If
  116. you wish to, you may do an "assign VD0: ..." to poll any other device that
  117. you wish.
  118.      The window can now be shrunk to a smaller size if needed, either by
  119. using the TINY command on startup or by selecting this feature on the
  120. menu.
  121.      A new highlight feature has been added to give a two tone option on the
  122. display.  You can even choose to have the "Time:" labels invisible!
  123.      The window color selection sub-menu has been made more "aesthetically
  124. pleasing".
  125.      An automatic command line execute function has been added.  If typed
  126. at the end of the command which runs RSLClock (and enclosed in quotations),
  127. by selecting the Copyright notice submenu you can summon any program into
  128. being! For example, my startup sequence is Run RSLClock "Run WTP" - this way
  129. I can run WTP (a PD terminal program) without dealing with my CLI!
  130. ****************************************************************************
  131.  
  132. ****************************************************************************
  133. Version "S":
  134.      Some people really seem to like the seconds ticking by, so I have made
  135. a very slightly modified version, noted with a "S" at the end of the
  136. version which has this feature on both 24 military and 12 hour standard
  137. styles.
  138. ****************************************************************************
  139.        
  140.      I know that there already is an abundance of "clock" programs, but this 
  141. is optimized for my own needs.  I hope that others find it useful!
  142.      I would like to thank Addison-Wesley, without whose ROM Kernal books,
  143. I would still be using my C compiler to compile "Hello there!" type programs.  
  144.      Please feel free to use this utility and distribute it freely.
  145.      Given all the suggestions for additional features, I hope that this 
  146. program hasn't grown TOO BIG for a utility.  I am presently considering adding
  147. an additional BACKSCRATCH option, using the chinese backscratch feature that
  148. was never a well documented feature in the Amiga A1000 hardware specs, it will
  149. scratch the user's back at a pre-selected interval!
  150.      Feel free to comment, suggest, compliment, and disparage, as you wish!
  151.      Happy Hacking!
  152.                                                    -RSL-
  153. AMuse BBS (212)269-4879: Roy S. Laufer
  154. CIS:  72435,1025
  155. Delpi: RSLaufer
  156.  
  157.  
  158. P.S. STILL LEFT TO BE DONE:
  159.      I would like to TOTALLY blank the screen, i.e disable the video DMA, but
  160. have yet to discover a "safe" way to do it!
  161.      I would also like to incorporate a timer for automatic "black-out" of
  162. the screen (ala PopCLI), but I will have to wait for an update of Aztec
  163. so that I can use assembler to do it right.  I've tried the 'C' source by
  164. Perry K. in his "ScreenSaver", but find its accuracy erratic (to be kind)!
  165.      If anyone has any suggestions, or 'C' source fragments feel free to 
  166. send them to me!